home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / dcall300.zip / DCALL.DOC next >
Text File  |  1992-08-19  |  10KB  |  253 lines
  1.                        ▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀   ▀▀▀▀▀▀▀
  2.                           ▀▀    ▀▀   ▀▀     ▀▀▀
  3.                           ▀▀    ▀▀   ▀▀▀   ▀▀▀
  4.                           ▀▀    ▀▀   ▀▀   ▀▀▀
  5.                           ▀▀    ▀▀▀▀▀▀   ▀▀▀▀▀▀▀
  6.  
  7.                 [The DeAdZoNe Utilities for RemoteAccess]
  8.  
  9.    ┌─────────────────────────────────────────────────────────────────┐
  10.    │                              D-CaLL                             │
  11.    │                                                                 │
  12.    │        Today's Callers Bulletin Generator for RemoteAccess      │
  13.    │                                                                 │
  14.    │                     Version 3.00   August 21, 1992              │
  15.    │                                                                 │
  16.    │                 (C) Copyright Victor Magdic 1992                │
  17.    │                                                                 │
  18.    │                        All Rights Reserved                      │
  19.    └─────────────────────────────────────────────────────────────────┘
  20.  
  21.  
  22. Description
  23. ═══════════
  24.  
  25.  D-CaLL is a door for RemoteAccess which replaces the built in
  26.  "Today's Callers" function. Not only does D-CaLL look better <grin>,
  27.  but it also has the following features:
  28.  
  29.      * Runs as a door.
  30.  
  31.      * The ability to mask local logons so that they look like
  32.        ordinary calls.
  33.  
  34.      * People who have only called one time (i.e. new users) are
  35.        listed as "NEW USER".
  36.  
  37.      * The ability to exclude up to 100 users from the Today's
  38.        Callers List, based on a control file which you create.
  39.  
  40.      * Supports the "hidden" attribute in the user record, so if
  41.        you have a user toggled as "hidden" they will not be
  42.        displayed in the Today's Callers List.
  43.  
  44.      * Supports Handles and Real Names.
  45.  
  46.      * Supports locked baud rates.
  47.  
  48.      * The screen length is adjusted to the users setting to provide full
  49.        screen display on the users end.
  50.  
  51.      * Does full carrier monitoring and will immediately return to the BBS
  52.        if the user drops carrier
  53.  
  54.      * Inactivity timeout feature. D-CaLL will return to the BBS if the
  55.        user does not respond within two minutes at the screen pause prompt.
  56.  
  57.      * DESQview aware. D-CaLL will give up it's time slice when waiting for
  58.        user input at the screen pause prompt. D-CaLL will automatically
  59.        detect if DESQview is present.
  60.  
  61.  
  62.  Note: D-CaLL 3.00 is written for RA 1.11 -it should work with future
  63.        versions as well, but that will depend on what changes are made to
  64.        the RA file structures. It will NOT work with versions prior to RA 1.11.
  65.  
  66.  
  67. How much does it cost?
  68. ══════════════════════
  69.  
  70.   This utility is FREE!  If you like it you can continue to use it
  71.   for as long as you like free of charge!
  72.  
  73.   If you do decide to use it, I would be excited to hear from you !!
  74.   I encourage you to send me a postcard at the address listed below (see
  75.   the end of this text file). It will cost you practically nothing, and
  76.   will let me know you're enjoying the program. It will also give me
  77.   incentive to keep improving the program and make it even better!
  78.  
  79.  
  80. Command Line Options
  81. ════════════════════
  82.  
  83.     DCALL [/H] [/T] [/L] [/Mxxxxx]
  84.  
  85.  D-CaLL supports the following options:
  86.  
  87.       /T                    ; Include the Sysop's name in the *header*
  88.                               portion of the Today's Callers Bulletin.
  89.                               (i.e. directly below the system name).
  90.                               This option is OFF by default.
  91.  
  92.  
  93.       /H                    ; Use Handles instead of real names. Real
  94.                               names is the default.
  95.  
  96.       /Mxxxxx               ; Specify the baud rate to be used when
  97.                               masking local logons (see explanation
  98.    or /M=xxxxx                below). The default is 2400 baud. If you
  99.                               want a different number specify it as follows:
  100.  
  101.                                  /M9600    -would use 9600 bps
  102.                                  /M=14400  -would use 14400 bps
  103.  
  104.       /L                    ; Local operation. If you want to test D-CaLL,
  105.                               or simply want to run it locally, use this
  106.                               switch. When this switch is used, nothing is
  107.                               written to the comm port.
  108.  
  109.  
  110. Masking Local Logons
  111. ════════════════════
  112.  
  113.   Normally when someone logs on locally to your BBS, RemoteAccess
  114.   reports their baud rate as "0", and will display it as "0" in the
  115.   "built in" Today's Caller List. In some circumstances it may not be
  116.   desirable for your users to know who is logging on locally... D-CaLL
  117.   solves this problem by automatically masking calls which have a baud
  118.   rate of "0".
  119.  
  120.   By default, if a baud rate of "0" is encountered, it is replaced by
  121.   "2400". You can overide this value and make it anything you want by
  122.   using the /M switch as explained above.
  123.  
  124.   Note: The "0" baud masking is completely internal and only occurs at
  125.         run time. It does not modify any RA files (e.g. LASTCALL.BBS
  126.         or USERON.BBS)
  127.  
  128.   Important:  D-CaLL does not check to see if you've entered a valid
  129.               baud rate, so be careful when you use this feature. For
  130.               example, if you were to enter something like /M1123,
  131.               this is the number which would be used in the bulletin.
  132.               Obviously, making an error like this would defeat the
  133.               purpose of masking the baud rate in the first place since
  134.               most people would recognize that 1123bps is not a "real"
  135.               baud rate!
  136.  
  137.  
  138. Exclusion List
  139. ══════════════
  140.  
  141.   D-CaLL supports an exclusion list which allows you to specify up to
  142.   100 users which you do not want included in the Today's Callers
  143.   Bulletin. This is useful if you have users (or co-sysops) which you
  144.   want to "hide" from the listing.
  145.  
  146.   In order to use this feature you must create a plain ASCII text file
  147.   called DCALL.CTL and simply list the name or handle of the user which
  148.   you want excluded (one entry per line). If D-CaLL detects this file,
  149.   it will automatically use it, so no command line switches are
  150.   required.
  151.  
  152.   * It is not necessary to specify both a user's real name and their
  153.     handle as separate entries, one or the other will suffice.
  154.  
  155.   * The entries in DCALL.CTL are *not* case sensitive, so if you have
  156.     "John Smith" in your DCALL.CTL file, and the users name is actually
  157.     spelt "JoHn SmItH", the name will still be properly excluded.
  158.  
  159.   * If you have more than 100 entries in DCALL.CTL, D-CaLL will abort
  160.     with an appropriate error message.
  161.  
  162.      Example of DCALL.CTL:
  163.  
  164.              John Smith
  165.              Jane Smith
  166.              The Punisher
  167.  
  168.  
  169. How To Use D-CaLL
  170. ═════════════════
  171.  
  172.   D-CaLL is designed to be run as a door. The best way to run it is
  173.   to set it up as a type 7 exit. D-CaLL will read all the necessary
  174.   comport information from the DORINFO1.DEF file.
  175.  
  176.     example;
  177.  
  178.              dcall.exe /H /T /M=9600
  179.  
  180.       This will tell D-CaLL to use Handles and include the sysop's name
  181.       in the header portion of the list. It will also tell D-CaLL to mask
  182.       local logons as 9600 baud.
  183.  
  184.  
  185. Location of Files
  186. ═════════════════
  187.  
  188.   In order for D-CaLL to function properly you must have your RA environment
  189.   variable set (see the RA docs for more information on the RA environment
  190.   variable).
  191.  
  192.   If you are using the exclusion file, DCALL.CTL, it must be in the main
  193.   RA directory (i.e. the directory specified by the RA environment variable)
  194.  
  195.   Note: D-CaLL does *not* write to any RemoteAccess files.
  196.  
  197.  
  198. Legal Stuff and Disclaimer
  199. ══════════════════════════
  200.  
  201.   "D-CaLL" refers to the executables and documentation in the original
  202.   distribution archive. D-CaLL is copyrighted material by the author,
  203.   Victor Magdic. All rights are reserved.
  204.  
  205.   The program is provided "as is", without warranty or guarantee of any kind,
  206.   either expressed or implied, as to its quality or performance. The author,
  207.   will not be held liable to you or anyone for any direct, indirect, incidental
  208.   or consequential damages, including but not limited to any lost profits, or
  209.   lost savings which may result from the use or inability to use this program.
  210.  
  211.   The author is in no way obligated to provide future versions of this
  212.   software.
  213.  
  214.   Your use of the program constitutes your agreement to these terms and to
  215.   this disclaimer and your release of the author from any form of liability
  216.   or litigation.
  217.  
  218.   All mentioned products are copyrighted by and trademarks of their respective
  219.   holders.
  220.  
  221.  
  222. Credits
  223. ═══════
  224.  
  225.   Thanks to James FitzGibbon for his patience in helping me beta test D-CaLL,
  226.   and a special thanks to Ian McKenzie for lending me his computer so I could
  227.   simulate a remote connection and debug the fossil routines.
  228.  
  229.  
  230. Suggestions always welcome!
  231. ═══════════════════════════
  232.  
  233.   If you have any suggestions for improvement or wish to report any bugs,
  234.   you can reach me either through my BBS, or via netmail:
  235.  
  236.                The DeAdZoNe        ...Experience the Difference!
  237.                (416) 507-2159
  238.                Victor Magdic -SysOp
  239.                FidoNet: 1:259/427
  240.                TeleNet Canada: 20:22/4
  241.                F-Net: 110:112/1
  242.  
  243.  
  244.   or by writing to:
  245.  
  246.               Victor Magdic
  247.               424 Camden Circle
  248.               Mississauga, Ontario
  249.               L4Z 2P4
  250.               CANADA
  251.  
  252. ═══════════════════════════════════════════════════════════════════════ end
  253.